home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1996 July / Macworld (1996-07).dmg / Shareware World / Resource / SoundVision D41 / SoundVision Manual < prev   
Text File  |  1996-01-31  |  12KB  |  201 lines

  1. SoundVision
  2. by Masafumi Ueda (hajime@singnet.com.sg)
  3. Version 68030-DELTA 41
  4.  
  5. Introduction to SoundVision ========
  6.  
  7. What is SoundVision? --------
  8.    As the name suggests, SoundVision is a tool to see sound. In other words, it is a real-time sound analyzer.
  9.  
  10. Features --------
  11.    SoundVision features its tremendous speed. On a MacIIsi with a 68030 / 40MHz accelerator, SoundVision can draw display with the following speeds:
  12.       - 128-point Spectrum Analyzer : 65 FPS, 150% of required.
  13.       - 256-point Spectrum Analyzer : 32 FPS, 73% of required.
  14.       - Oscilloscope : 3850 FPS, 8855% of required.
  15.       - Spectrogram : 74 FPS, 170% of required.
  16.       - 128-point Composite View : 55 FPS, 125% of required.
  17.       - 256-point Composite View : 30 FPS, 70% of required.
  18.  
  19.    Since most Macs today has a CPU faster than 68030 / 40MHz, SoundVision works faster than this figure on most of Macs. However, SoundVision seems to work rather slowly on PowerMacs.
  20.  
  21. Requirements --------
  22.    SoundVision requires the followings:
  23.       - 68030, 68LC040, 68040, or PowerPC.
  24.             NOTE : SoundVision seems to have a trouble on 604 Macs.
  25.       - Sound input device (i.e. microphone).
  26.       - 256-color or 256-gray mode monitor.
  27.       - System booted in 32-bit addressing mode.
  28.       - System 7.0 or above (7.5 suggested).
  29.       - 192K of FREE memory (not the total memory).
  30.       - Enough space on screen to place SoundVision's window.
  31.  
  32. Distribution --------
  33.    SoundVision is distributed as a FREEWARE. It means you don't have to worry about paying fee for using it (of course, you can pay for it). You can copy it and use it as much as you like, but YOU MAY NOT SELL, RENT, OR ALTER IT! Hand-by-hand distribution and uploading to BBS or FTP sites are basically free, however, IF YOU WANT TO INCLUDE SOUNDVISION IN ANY MEDIA (e.g. floppy, CD-ROM, MO) THAT YOU ARE GOING TO PUBLISH, PLEASE GET PERMISSION FROM ME (THE AUTHOR) BEFORE!
  34.  
  35.  
  36. Setting SoundVision Up ========
  37.  
  38. Setting Up Your Mac for SoundVision --------
  39.    - If your system is currently running under 24-bit addressing mode, turn on 32-bit addressing mode in Memory control panel and restart your computer.
  40.    - Set your screen to 256-color/gray mode.
  41.  
  42. Setting Up Input Device --------
  43.    SoundVision has its own recording preferences. Every time you start up SoundVision, it sets options of your input device to the preference. You may find the default preference does not fit to your environment. In that case, you can customize it by doing followings :
  44.    - Choose Recording Preferences... from Options menu.
  45.    - In the dialog, choose sampling frequency, sound source, AGC, play-through that you want to use in SoundVision.
  46.    CAUTION : SoundVision DOES NOT support 16-bit sampling size and stereo sampling. You can still set input options to 16-bit stereo, although you will not get correct result.
  47.    - Click Save as Default button.
  48.    - Click OK button.
  49.  
  50.  
  51. Having a Fun ========
  52.  
  53. Running SoundVision --------
  54.    - Double-click SoundVision’s icon.
  55.    - Move SoundVision’s window so that NO part of it is hidden by other window and / or edges of monitor.
  56.  
  57.  
  58. Customizing SoundVision --------
  59.  
  60. Display Types ---
  61.    SoundVision has 4 display types :
  62.       - Spectrum Analyzer
  63.          Shows spectrum of sound. Spectrum is a graphical way of showing how we hear. It shows power (loudness, Y-axis) of frequencies (pitches, X-axis) that are mixed in sound.
  64.  
  65.       - Oscilloscope
  66.          Shows waveform of sound.
  67.  
  68.       - Composite
  69.          Shows waveform and spectrum of sound at the same time.
  70.  
  71.       - Spectrogram
  72.          Shows spectrum of sound. The difference between spectrogram is that power is shown by color, and X-axis shows time.
  73.  
  74.    You can choose one of them from Display menu.
  75.  
  76.  
  77. Display Labels ---
  78.     Display labels are little tags and numbers on X and Y axis on  the display. In Spectrum Analyzer, X labels shows frequency of sound in Hertz, and Y labels shows power of sound. In Oscilloscope, Y labbls shows power of sound. 
  79.    You can choose either show or hide the display labels. Labels don’t take up any extra CPU time, but they take up extra space on your screen. If you want to hide them, choose Labels from Display menu so that the menu item is not checked and labels are not there.
  80.  
  81.  
  82. RDS (Redundant Drawing Suppression, sorry, not Random Dot Stereogram)---
  83.    RDS suppresses SoundVision to analyze and calculate the same data twice. It minimizes SoundVision’s CPU load, and may prevemt flickers and jumping off frames. It may be better to keep RDS on usually. With RDS on, SoundVision NEVER works faster than 43.5FPS, 100% of required speed.
  84.    RDS can be switched by choosing RDS under Display menu.
  85.  
  86. Display Options --------
  87.    All the display options are listed under sub-menus of Options menu. You can customize SoundVision by changing display options.
  88.  
  89. Spectrum Analyzer ---
  90.  
  91. - Linear Freq. Scale / Logarithmic Freq. Scale
  92.    It determines how frequencies of spectrum are plotted on the display. Linear scale is based on frequency of sound, and logarithmic scale is rather based on musical pitch of sound. In another word, logarithmic scale is based on how we hear differences in pitches of sound. I think most people feel comfortable with logarithmic scale, and linear scale is useful in the lab.
  93.    SoundVision’s logarithmic scale is logarithm of 2.
  94.    Logarithmic scale takes a tiny bit of extra CPU time.
  95.  
  96. - Wireframe Drawing
  97.    With this mode on, SoundVision draws only frames of spectrum, instead of filling and making them look like columns. This option is most useful in Composite mode, where spectrum can cover up most of oscilloscope beam.
  98.    Wireframe drawing mode is slower than normal drawing mode, since there is always a need to redraw whole display.
  99.  
  100. - Slow Decay
  101.    You will find that there are real annoying flickers in spectrum, especially if you are using logarithmic scale. This option slows down decay of spectrum and eliminates the flicker. It also gives display some smoothness.
  102.    You can change speed of decay under Decay Amount....
  103.    Slow Decay takes a bit of extra CPU time, but since it eliminates flickers, usually it speeds up SoundVision.
  104.  
  105. - Spectrum Reduction
  106.    Sometimes when recorded sound is real loud, all the frequencies of spectrum reach the top of display and it becomes unable to read. This option reduces spectrum and make them fit within the display. You can change the amount of reduction under Reduction Amount....
  107.    Spectrum Reduction requires NO extra CPU time since no reduction is regarded as 1/1.
  108.  
  109. - 128-Point FFT / 256-Point FFT
  110.    It determines resolution of spectrum. 256-point FFT gives you more detailed spectrum, but takes more CPU time.256-point FFT is too hard for 68030 Macs. If your Mac has 68LC040 or 68040, he/she will do a good job on 256-point FFT. Choose them depending on your Mac’s performance.
  111.  
  112. - Color
  113.    I understand some people hate a certain color and some love it. If you don’t like color of spectrum, you can choose it under Choose Color....
  114.    Even if you really love black, don’t choose it or you will be unable to see the spectrum!
  115.  
  116.  
  117. Oscilloscope ---
  118.  
  119. - AI Slope / Slope / Continuous Trigger
  120.    This determines when SoundVision starts recording a new piece of sound. In continuous trigger mode, SoundVision just records a new piece of sound from where the end of previous sound piece was. In slope trigger mode, SoundVision starts recording a new piece of sound when the sound wave comes to its node (null point).
  121.    AI Slope Trigger is an advanced Slope Trigger. It tries to find the sound node that is most suitable for sound wave observation. You will find that you can observe sound waves a lot easier under AI Slope Trigger mode. This trigger mode also gives Spectrum Analyzer sensitivity and stability to particular sounds.
  122.    This option effects to sound sample that Spectrum Analyzer uses.
  123.  
  124. NOTE : Slope trigger mode (including AI) CANNOT be used with 256-point Spectrum Analzer (It gets temporary turned off automatically).
  125.  
  126. - Line Drawing
  127.    With this mode on, SoundVision draws sound waves with lines rather than dots. Of course, it is a lot easier to see sound waves under this mode. The only problem is that it takes more CPU load than dot drawing mode and it may slow down Composite view on slow Macs.
  128.  
  129. - Color
  130.    " (same as above).
  131.    Be careful. Don’t choose the same or too close color as Spectrum Analyzer since they will interfere each other in Composite display.
  132.  
  133.  
  134. Spectrogram ---
  135.  
  136. - Grayscale / Rainbow  Colors
  137.    Choose one of the sets of colors that you like more.
  138.  
  139.  
  140. Other Stuff --------
  141.  
  142. Faster Mode ---
  143.    Sometimes if there’s many applications running behind SoundVision, they slow down SoundVision. In that case, Choose Faster Mode from File menu. SoundVison will go on faster mode, which disables all the background processes except VBL and Time Manager tasks and make CPU concentrate on SoundVision. You can exit from Faster Mode by clicking mouse.
  144.  
  145. Exporting Spectrum Data ---
  146.    You can export spectrum data of a single frame as a text file. Choose Export Spectrum Data as... from File menu. 
  147.    SoundVision writes files in spreadsheet-importable way. You can import saved files into spreadsheets and then modify and/or plot graphs.
  148.  
  149. Copying Display ---
  150.    By choosing Copy from Edit menu, you can copy the display (including labels). You can then paste it on documents as a normal picture.
  151.  
  152. Measuring SoundVision’s Speed ---
  153.    You can measure how fast SoundVision is doing its work. SoundVision has 2 types of benchmarkers, and they can be activated by choosing menu items under Benchmark menu.
  154.  
  155.  - Average Speed Benchmarker
  156.    Average speed benchmarker gives you the average speed during a period of time. After choosing the menu, wait for 2 minutes or so, and click mouse. SoundVision then gives you the benchmark report. Usually, the longer you wait, the more accurate the report is.
  157.    The data in the report that you might want to look at is Performance. It shows what proportion of sound is analyzed and displayed completely. Of cource, higher is better, but don’t be too strict on it. ±2% doesn’t give much difference, so if the report says 99%, regard it as 100%. There is NO upper limits on Performance.
  158.  
  159.  - Instantaneous Speed Benchmarker
  160.    Instantaneous speed benchmarker is somewhat like a speedometer. The benchmarker shows benchmark report in the space above the display. The report has Performance and FPS values, and they get updated once in every second. Both values are the same things as in the report of the average speed benchmarker. HOLD DOWN mouse button to end the benchmark.
  161.  
  162. NOTE : THIS BENCHMARKER NEEDS LABELS TO BE TURNED ON. OTHERWISE IT JUST BEEPS UP. 
  163.  
  164.  
  165. Please Note ========
  166.  
  167.    I (THE AUTHOR) WILL NOT BE RESPONSIBLE FOR ANY DAMAGE THAT HAS OCCURRED ON YOUR MAC, NO MATTER IT IS CAUSED BY USING SOUNDVISION OR NOT. USE THIS PROGRAM AT YOUR OWN RISK.
  168.  
  169.  
  170. Blah Blah Blah ========
  171.    I would like to know how you think about SoundVision. If you have any comments for SoundVision, please send me a mail. I appreciate ANY comments!
  172.  
  173.    My address : hajime@singnet.com.sg
  174.  
  175. References ========
  176.                         General : THINK Reference
  177.  Assembly Language : Panos E. Livadas, Christopher Ward
  178.                                          “Computer Organization and the MC68000”
  179.                                           © 1993 by Prentice-Hall Inc.
  180.         Drawing Routine : Jim Bumgardner, “Cheese Toast 1.0 Source”, © 1993 Jim Bumgardner
  181.                           WDEF : Scott Knaster, Keith Rollin, “Mac Programming Secrets 1.0.1”
  182.                 FFT Routine : Shigeo Minami, “Kagaku keisoku no tameno hakei data shori”,
  183.                                           © 1986 Shigeo Minami, CQ Publishing
  184.  
  185.  
  186. Thanks to ========
  187.     Hajime Ueda for Trigonometric Routine
  188.     Satoru Nishisaka for tips about Assembly Language / Fast Drawing Routine
  189.     SoundVision users, including you!
  190.  
  191.  
  192. Copyright Note ========
  193. SoundVision
  194. ©Masafumi Ueda 1994-1996
  195. All rights reserved worldwide.
  196.  
  197. All trademarks are properties of their owners.
  198.  
  199.  
  200.  
  201. Jan. 13, 1996